9.1. Зачем управлять страницей из кода
В уроке 8 кнопка уже реагировала на клик: срабатывал обработчик, число кликов увеличивалось и уже показывалось на странице в блоке #clickCount. Но, кроме этого числа, на странице ничего не менялось. В уроке 9 страница начинает меняться целиком — появляются сообщение, уровень, блок статистики и класс кнопки.
Пора двигаться дальше. К концу урока на странице появятся сообщение о заклинании и блок статистики со счётчиком и уровнем магии — и всё это будет меняться прямо во время игры. Для этого нужно научиться трём вещам: находить элемент, менять его содержимое и оформление, создавать новые.
Инструмент для всего этого один — DOM. За словом стоит простая идея: браузер превращает текст разметки в набор объектов, с которыми JavaScript умеет работать. Пока ты не умел к ним обращаться, страница была для кода закрытой книгой.
9.2. DOM: страница как дерево
DOM расшифровывается как Document Object Model — «объектная модель документа». Прочитав HTML, браузер строит из тегов дерево: каждый тег становится узлом, а вложенные теги — его детьми. Главный узел — document, внутри него html, дальше head и body и так до самой глубокой кнопки.
Для нашей игры дерево выглядит примерно так:
document
└── html
├── head
│ └── title
└── body
└── div.game-container
├── h1
├── button#magicButton
├── p#magicMessage
└── div.stats
├── div.stat-item
│ └── div.click-count#clickCount
└── div.stat-item
└── span#magicLevel
Каждый узел — это объект: у него есть свойства (текст, класс, стиль) и команды (добавить класс, удалить себя). Работа с DOM — это и есть вызов таких свойств и команд. Дерево удобно тем, что элемент помнит своих детей и родителя.
9.3. Как увидеть DOM в DevTools
Дерево не нужно представлять в уме — его видно. Открой страницу, нажми F12 и перейди на вкладку Elements (в некоторых браузерах — «Элементы» или «Инспектор»): там та же разметка, что в файле, только свёрнутая в дерево.
- Наведи мышь на строку — браузер подсветит элемент на странице.
- Разверни
bodyи дойди до кнопки: так видно вложенность. - Справа показаны стили выбранного элемента.
Здесь же легко проверить себя: если в дереве у кнопки id="magicBtn", а в скрипте ты ищешь magicButton, код ничего не найдёт и ошибки не покажет.
9.4. Как код находит элемент
Вход в дерево — объект document: он существует с момента загрузки страницы, и через него код ищет элементы. В уроке 8 мы уже пользовались document.getElementById("magicButton") — поиском по id.
При этом id и class получили вторую работу: в уроках 4–6 они были нужны только для CSS, а теперь по ним JavaScript находит элементы. Поэтому id должен быть уникальным, а класс описывает группу похожих элементов.
<button class="magic-button" id="magicButton">✨ МАГИЯ! ✨</button>
<p class="magic-message" id="magicMessage">Нажми на кнопку, чтобы увидеть волшебство!</p>
<div class="stats">
...
</div>
Здесь magicButton и magicMessage — имена для поиска, а magic-button и stats — классы для оформления. Один элемент может иметь и то, и другое.
9.5. querySelector: поиск по CSS-селектору
Второй способ — querySelector. В скобках ему передают селектор, ту же запись, что и в CSS. Самые нужные:
"#magicButton"— элемент сid="magicButton";".stat-item"— первый элемент с классомstat-item;"h1"— первый заголовок первого уровня;".stats #clickCount"— элемент сid="clickCount"внутри блока.stats;"button.magic-button"— кнопка, у которой есть классmagic-button.
const button = document.querySelector("#magicButton");
const message = document.querySelector("#magicMessage");
const stats = document.querySelector(".stats");
console.log(button);
console.log(message);
console.log(stats);
querySelector возвращает первый подходящий элемент. Если их несколько, остальные он не вернёт — для них есть другой способ, о котором ниже. Удобство в том, что запись селектора ровно такая же, как в CSS.
9.6. querySelectorAll: когда элементов несколько
В блоке статистики два одинаковых элемента .stat-item. Чтобы обратиться ко всем сразу, используют querySelectorAll: он возвращает список найденных элементов, по которому можно пройти циклом.
const items = document.querySelectorAll(".stat-item");
console.log(items.length); // сколько элементов нашлось
items.forEach(function (item) {
item.classList.add("stat-item-light");
});
console.log(items[0].textContent); // текст первого элемента
У списка есть длина length и метод forEach: он по очереди передаёт каждый элемент в функцию, которая с ним что-то делает. К отдельному элементу можно обратиться по номеру: items[0] — первый. Нумерация начинается с нуля.
9.7. Если элемент не найден: null
Что будет, если элемента с таким селектором нет? querySelector не выдумывает его и не выбрасывает ошибку сразу — он возвращает особое значение null, то есть «ничего не найдено»:
const message = document.querySelector("#magicMesage"); // опечатка в id
console.log(message); // null
Само по себе null — не беда. Беда начинается на следующей строке: если попробовать обратиться к свойству несуществующего элемента, браузер остановит скрипт и напишет ошибку вида TypeError: Cannot set properties of null.
null, сравни посимвольно имя в селекторе и имя в разметке: magicMessage и magicMesage — разные имена. Второй случай — скрипт стоит раньше элемента; об этом в конце урока. Подробный разбор ошибок — в уроке 12.
9.8. textContent: текст элемента
Когда элемент найден, у него можно прочитать или заменить текст. За это отвечает свойство textContent. Читать его можно как обычное значение, а записывать — через знак равенства, как в переменную.
const message = document.querySelector("#magicMessage");
console.log(message.textContent); // что написано сейчас
message.textContent = "✨ Заклинание сработало!";
console.log(message.textContent); // что написано после замены
Присваивание заменяет всё содержимое элемента целиком. Если приклеить к строке число, получится «Заклинание №3 сработало» — так же, как мы склеивали строки в уроке 7, только результат виден не в консоли, а на странице.
textContent. Сам элемент остаётся тем же — меняется только его содержимое.9.9. innerHTML: разметка внутри элемента
У элемента есть ещё одно свойство — innerHTML. textContent вставляет символы как текст, а innerHTML сначала разбирает строку как разметку и только потом вставляет результат:
// текст: теги будут видны как обычные символы
message.textContent = "<strong>Магия!</strong>";
// разметка: слово станет жирным
message.innerHTML = "<strong>Магия!</strong>";
В первом случае появится строка с угловыми скобками, во втором — жирное слово «Магия». Отсюда правило: обычный текст — textContent, разметка, которую ты написал сам, — innerHTML. И никогда не передавай в innerHTML то, что ввёл пользователь: чужие теги могут сломать страницу. В нашей игре хватает textContent.
9.10. classList: add, remove, toggle, contains
Классы мы до сих пор писали только в разметке. Из кода их меняет classList — набор команд, привязанный к элементу. Команд четыре:
button.classList.add("magic-active"); // добавить класс
button.classList.remove("magic-active"); // убрать класс
button.classList.toggle("magic-glow"); // включить, если нет; выключить, если есть
button.classList.contains("magic-active"); // проверить: true или false
Не нужно возиться со строкой классов вручную: add не добавит класс второй раз, remove не сломается, если класса не было, а toggle по очереди включает и выключает класс. contains ничего не меняет, а только отвечает на вопрос.
И ещё одно: класс сам по себе ничего не делает — он меняет вид элемента только тогда, когда для него написано правило в CSS. Поэтому в проекте появится правило для класса magic-active.
9.11. element.style: оформление из кода
Отдельные свойства оформления можно задать напрямую — через style. Запись похожа на CSS, но с двумя отличиями: дефис из названия убирается, а бывшая вторая часть пишется с заглавной буквы; размеры задаются строкой вместе с единицами измерения.
message.style.color = "#ffeb3b";
counter.style.fontSize = "36px";
counter.style.marginTop = "10px";
level.style.letterSpacing = "1px";
В CSS ты писал font-size, а в коде пишешь fontSize. Так же background-color становится backgroundColor. Размеры указывают строкой с единицами: "36px", а не 36. Для безразмерных свойств подходит число: style.opacity = 1.
Есть и setAttribute — он задаёт любой атрибут HTML:
button.setAttribute("title", "Нажми и получи заклинание");
console.log(button.getAttribute("title"));
style. Десять строк style подряд читать труднее, чем одно правило в CSS.
9.12. Создание и удаление элементов
До сих пор мы работали с элементами из разметки. Но код умеет создавать новые: сначала элемент создаётся в памяти, потом вставляется на страницу. Пока не вставлен — его никто не увидит.
const note = document.createElement("p"); // создать абзац в памяти
note.textContent = "Новое заклинание"; // заполнить текстом
note.classList.add("stat-item"); // добавить класс
document.querySelector(".stats").appendChild(note); // вставить на страницу
note.remove(); // убрать со страницы
createElement принимает имя тега и возвращает пустой элемент. appendChild вызывается у родителя и вставляет элемент последним ребёнком. remove вызывается у самого элемента и убирает его из дерева; переменная note остаётся, но элемента на странице уже нет.
Обрати внимание на порядок: createElement сам по себе ничего не показывает, элемент появляется только после appendChild. А remove работает с уже вставленным элементом, поэтому вызывать его нужно после вставки. Именно так в практикуме появится строка «Последнее заклинание», а в уроке 11 — искры, которые исчезают сами.
9.13. Порядок в файле и новый код проекта
Есть правило, без которого всё предыдущее не работает: скрипт должен выполняться после того, как разметка загружена. Браузер читает файл сверху вниз, поэтому скрипт в head выполнится, когда body ещё пуст, и любой querySelector вернёт null. В уроке 7 мы поставили скрипт в конец body — после всех элементов.
<script> в head, игра перестанет работать: код ищет кнопку, которой ещё нет. Ошибка будет та же — Cannot read properties of null (reading 'addEventListener'). Место скрипта — не мелочь.
В разметку добавляется сообщение, а прежний блок #clickCount из урока 8 заменяется новым блоком статистики:
<p class="magic-message" id="magicMessage">Нажми на кнопку, чтобы увидеть волшебство!</p>
<div class="stats">
<div class="stat-item">
Количество заклинаний:
<div class="click-count" id="clickCount">0</div>
</div>
<div class="stat-item">
Уровень магии: <span id="magicLevel">Начинающий волшебник</span>
</div>
</div>
А в скрипт — четыре найденных элемента и обновление их содержимого по клику. Функция magicClick остаётся: мы её только дополняем.
const button = document.querySelector("#magicButton");
const message = document.querySelector("#magicMessage");
const counter = document.querySelector("#clickCount");
const level = document.querySelector("#magicLevel");
let clicks = 0;
function magicClick() {
clicks = clicks + 1;
counter.textContent = clicks;
message.textContent = "✨ Заклинание №" + clicks + " сработало!";
level.textContent = "Уровень: " + clicks;
counter.style.fontSize = (20 + clicks) + "px";
button.classList.add("magic-active");
}
button.addEventListener("click", magicClick);
Разберём главное. counter.textContent = clicks выводит число на страницу, сообщение собирается из строки и числа. Уровень пока просто число: настоящие названия появятся в уроке 10. Размер числа растёт с каждым кликом — временный эффект. Класс magic-active добавляется один раз и остаётся на кнопке, а чтобы он что-то менял, в <style> нужно правило:
.magic-button.magic-active {
background: linear-gradient(135deg, #22c55e, #16a34a);
box-shadow: 0 12px 28px rgba(34, 197, 94, 0.45);
}
Запись .magic-button.magic-active означает «элемент, у которого есть оба класса сразу». Пока класс не добавлен кодом, правило не действует.
9.14. Итог урока
Страница перестала быть неподвижной: код нашёл элементы, поменял их текст, добавил класс и даже создал новые элементы. Всё это — работа с DOM, и устроена она одинаково для любой страницы.
- DOM — дерево объектов, которое браузер строит из HTML; файл и DOM — разные вещи.
document.querySelectorнаходит первый элемент по CSS-селектору,querySelectorAll— все подходящие.textContentменяет текст,innerHTML— разметку внутри элемента.classListумеетadd,remove,toggleиcontains;styleзадаёт отдельное свойство оформления.createElementиappendChildсоздают элемент,removeудаляет его со страницы.- Скрипт стоит после разметки, иначе элементы ещё не существуют и поиск вернёт
null.